home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / mailers / faste120.zip / FASTECHO.DOC < prev    next >
Text File  |  1992-07-09  |  39KB  |  1,039 lines

  1.  
  2.  
  3.  
  4.  
  5.  ═══════════════════════════════════════════════════════════════════════════
  6.         ██████  ██████  ██████  ██████
  7.        ██      ██  ██  ██        ██       E C H O  &  F E U t i l  V1.20
  8.       ██      ██  ██  ██        ██
  9.      █████   ██████  ██████    ██          Written by Tobias Burchhardt
  10.     ██      ██  ██      ██    ██
  11.    ██      ██  ██      ██    ██  (c)1991/'92 by Software Technik Burchhardt
  12.   ██      ██  ██  ██████    ██
  13.  ═══════════════════════════════════════════════════════════════════════════
  14.  
  15.  
  16.  
  17.  
  18. Features at a glance
  19. ====================
  20.  
  21.    * Very fast and fully featured TOSSER/SCANNER for QBBS-Messagebase
  22.  
  23.    * powerful internal AreaFix with  'Forwarding'-feature  and  automatical
  24.      unlinking of passive Passthrough-areas (*registered version only*)
  25.  
  26.    * Dupe checking
  27.  
  28.    * Complete netmail routing and packing, handling of QBBS netmail-boards.
  29.  
  30.    * Networking and multitasking support. Can be simultaneously be used  in
  31.      RemoteAccess(tm)- or FrontDoor(tm)-multiline-environments. Messagebase
  32.      will be locked while execution. Read messages while tossing in another
  33.      task.
  34.  
  35.    * Nice Full-screen tossing mode
  36.  
  37.    * Complete  zone  and point support. This applies  to inbound as well as
  38.      outbound mail.
  39.  
  40.    * Full ARCmail-security using passwords with 3 levels.
  41.  
  42.    * Complete QBBS-messagebase-maintenance-utility included. No need to use
  43.      additional utilities.
  44.  
  45.    * Full-screen integrated SETUP utility,  no  need  to  use  an  external
  46.      editor.
  47.  
  48.    * Automatic area-adding function with optional updating  of RemoteAccess
  49.      (tm) area setup. (*registered version only*)
  50.  
  51.    * Carbon-Copy-function - filter out special messages and  copy  them  to
  52.      special boards while tossing.
  53.  
  54.    * Compatible with the FTSC standards FTS-0001  as  well  as  FSC-0039  &
  55.      FSC-0048.
  56.  
  57.    * Direct screen-writes, DESQview(tm)-aware, use of ANSI.SYS possible
  58.  
  59.  
  60. Shareware Notice, Legal Stuff and Disclaimer
  61. ============================================
  62.  
  63.     This is copyrighted software owned by Software Technik Burchhardt. This
  64.   is NOT public domain or freeware.  Software Technik Burchhardt grants you
  65.   a  TEMPORARY  license to try this software for EVALUATION purposes ONLY !
  66.   You may use this package for an evaluation time of 30 days.   After  this
  67.   time  you  have  to  register  FastEcho  or  stop using it ! Any other or
  68.   further use of this software is strictly  forbidden  and  may  result  in
  69.   legal action !
  70.  
  71.     To  register  FastEcho, please refer to LICENSE.DOC and the order forms
  72.   included in REGISTER.LZH in this package.
  73.  
  74.     FastEcho  is  provided  'as  is', without warranty of any kind, neither
  75.   expressed nor implied. I only guarantee FastEcho and the  included  tools
  76.   occupy diskspace.
  77.  
  78.     In no event will the author be liable to you for any damages, including
  79.   lost profits, lost savings or other incidental or  consequential  damages
  80.   arising out of the use of this program.
  81.  
  82.     All  mentioned  products and packages are copyrighted by and trademarks
  83.   of their respective holders.
  84.  
  85.  
  86.  
  87. Description
  88. ===========
  89.  
  90.     FastEcho  is one of the fastest tosser/scanner for the QBBS-Messagebase
  91.   (aka  the  Hudson-Messagebase) currently available.  Further, the package
  92.   contains all features needed to run a point or  a  node;  smart  netmail-
  93.   packing/routing included. Typically every step TOSS, SCAN and PACK is run
  94.   in  one  pass, including un-/packing of mail-bundles, importing/exporting
  95.   of mails and processing of AreaFix-requests.
  96.  
  97.     It can be run with FrontDoor(tm), D'Bridge(tm) and BinkleyTerm(tm)  and
  98.   has currently been tested with FrontDoor 2.02/nc, 2.10/c,  D'Bridge  1.30
  99.   and newer Betas and BinkleyTerm(tm) 2.5?.
  100.  
  101.     This  documentation  is  only a simple guide for you to get to know the
  102.   most important facts  about  FastEcho.  It  doesn't  contain  a  complete
  103.   description of FastEcho and the included tools. If you have any questions
  104.   about  the  possibilities of FastEcho, first of all run all programs with
  105.   '?' - you'll get a  usage-screen  that  will  help  you  in  most  cases.
  106.   Further,  rely on the context-sensitive-online-HELP provided with FESETUP
  107.   - simply press F1.
  108.  
  109.  
  110. System Requirements
  111. ===================
  112.  
  113.     Soft- & Hardware
  114.     ----------------
  115.  
  116.         * An IBM PC, XT, AT or compatible, i386/i486 CPU supported
  117.  
  118.         * DOS 3.31+ or OS/2 2.0 DOS compatibility box
  119.  
  120.         * FrontDoor 2.02/nc, FrontDoor 2.10/c, D'Bridge 1.30+ or
  121.           BinkleyTerm 2.50+, optionally RemoteAccess 1.10+
  122.  
  123.         * A fido '*.msg' style netmail-directory
  124.  
  125.         * A QBBS-style messagebase
  126.  
  127.         * Optionally an RA/QBBS-compatible BBS-software
  128.  
  129.         * Memory requirements:
  130.  
  131.                 FastEcho           upto 350kB   (1kB when swapping)
  132.                 FEUtil             upto 512kB
  133.                 FESetup                 250kB
  134.  
  135.         * a FILES=??? in your CONFIG.SYS at least at the number of systems
  136.           specified in the Node-Manager plus 20
  137.  
  138.           Example:  30 systems specified  -->  FILES=50
  139.  
  140.  
  141.     At least one of these de-/compression utilities:
  142.  
  143.         * PKZIP/PKUNZIP 1.10 (successfully tested with 1.93alpha)
  144.         * ARJ 2.30
  145.         * LHARC 1.13c/LHa 2.13
  146.         * PKPAK/PKUNPAK 3.61
  147.         * ARC 6.02
  148.         * ZOO 2.10
  149.         * PAK 2.51
  150.  
  151.  
  152.     Optionally   an  extractor  program  that  copes  with  different  de-/
  153.   compression programs like:
  154.  
  155.         * General Unpack Shell GUS 1.50 or later
  156.         * PolyXarc 2.1a or later
  157.  
  158.  
  159.     For  a  much  better  performance  on  node systems forwarding mails to
  160.   downlinks it is strongly advised to set the 'Temporary'  path  to  a  RAM
  161.   disk   with   at   least  1MB  storage.  FastEcho  will  create  outbound
  162.   mail-packets on this disk which speeds up the tossing  pretty  much.  The
  163.   more mail you have to forward, the bigger the RAM disk should be.
  164.  
  165.     If  SHARE  is  loaded,  FastEcho   supports   Messagebase-Sharing   and
  166.   RemoteAccess(tm)-Messagebase-Locking.   You  can read messages within one
  167.   task while tossing or scanning in the  other  task.   This  may  also  be
  168.   called 'Network Mode'.
  169.  
  170.     FEUtil and FastEcho automatically  detect  a i386  or  higher  CPU  and
  171.   use  some  optimized routines. If you recognize any problems, you may use
  172.   "SET FEOPT=NO386" to disable the 386-support.
  173.  
  174.  
  175. Considerations for registered users of FastEcho 1.0?
  176. ====================================================
  177.  
  178.     This  new  version of FastEcho behaves different on Node-systems and on
  179.   Point-systems.  Therefore there are two different kinds of keys available
  180.   at  different  prices.  All keys created for FastEcho 1.0?  are so called
  181.   'Point-Keys', they disable the new version's possibility of downlinks and
  182.   the processing of AreaFix-mails.  If you became a node (or  already  were
  183.   when  registering 1.0? but didn't need the new features at this time) and
  184.   now  NEED  the downlink capabilities I suggest the following to work with
  185.   the new FastEcho until you get a new key:
  186.  
  187.     Rename  the  FASTECHO.KEY  to  somewhat  else,  so FastEcho doesn't any
  188.   longer recognize it and runs as 'Unregistered Evaluation Copy'. Play some
  189.   time with it and find out  on  yourself,  if  it's  worth  updating  your
  190.   existing  'Point-Key'  to a 'Node-Key'.  [See REGISTER.LZH for details on
  191.   updating an existing key]
  192.  
  193.     Note: the fact that you have registered the 1.0? does NOT allow you  to
  194.   use  FastEcho  as a 'unregistered' copy longer than the evaluation period
  195.   mentioned in the Shareware Notice !!!
  196.  
  197.  
  198. Short Installation Guide
  199. ========================
  200.  
  201.     If you have worked with tossers like Tosscan(tm), IMail(tm),  GEcho(tm)
  202.   etc.  I don't think that the installation of FastEcho will be hard to do.
  203.   You only need a AREAS.BBS [well, it's not really needed, but it will save
  204.   you a lot of time and work] and the knowledge about your  system  [paths,
  205.   addresses  etc.].  Simply run FESetup and I guess you'll find it familiar
  206.   to other software-packages. FESetup can  import  the  some  configuration
  207.   files of IMail 1.21a and GEcho 1.00/beta as well as an AREAS.BBS file for
  208.   an easy setup.
  209.  
  210.     Pressing F1 will give you  a  context-sensitive  help  on  almost  each
  211.   topic.  I suggest to use this feature any time you have problems with the
  212.   setup. Therefore I didn't include the information given in this  help  in
  213.   this document.
  214.  
  215.  
  216.         FESetup
  217.  
  218.                 Information     Gives a short notice about the program
  219.  
  220.                 Shell to DOS    self-explanatory
  221.  
  222.                 Quit            dito
  223.  
  224.  
  225.         Edit
  226.                 Matrix-Addresses
  227.  
  228.                                 Here   you   place  YOUR  address(es),  the
  229.                                 domain(s) and - if you are a point  -  your
  230.                                 Pointnet [aka Fakenet]
  231.  
  232.  
  233.                 User names
  234.  
  235.                                 These  are  typically  the  name(s)  of the
  236.                                 sysop(s)   currently   using   your  mailer
  237.                                 locally.
  238.  
  239.  
  240.                 System-Data
  241.  
  242.                                 Your paths etc.
  243.  
  244.  
  245.                 Group names
  246.  
  247.                                 Here you can assign names  for  the  groups
  248.                                 later  used in the Area-Manager to make the
  249.                                 handling of the areas more easier.
  250.  
  251.  
  252.  
  253.                 Advanced Options
  254.  
  255.                                 Several options/parameters for FastEcho
  256.  
  257.  
  258.                 FEUtil parameters
  259.  
  260.                                 Several options/parameters for FEUtil
  261.  
  262.  
  263.                 Compression Programs
  264.  
  265.                                 Upto 8 different programs  for  compressing
  266.                                 OUTGOING mail-bundles
  267.  
  268.  
  269.                 Decompression Programs
  270.  
  271.  
  272.                                 FastEcho automatically detects the archiver
  273.                                 used   for  compression  of  inbound  mail-
  274.                                 bundles. Therefore you  have  to  tell  him
  275.                                 which  decompression  program (and command-
  276.                                 line) he should run to unpack them.
  277.  
  278.  
  279.                 Node-Configuration
  280.  
  281.                                 Here  you  set  up  all  the  nodes you are
  282.                                 exporting  (net-)mails  to. For help on the
  283.                                 different  flags  rely  on   F1   and   the
  284.                                 documentation of your mailer
  285.  
  286.  
  287.                 Origin-Lines
  288.  
  289.                                 These  lines  will  be used, if your editor
  290.                                 doesn't include "* Origin:"'s in your echo-
  291.                                 mails
  292.  
  293.  
  294.                 Area-Configuration
  295.  
  296.                                 Here you specify all your areas. Note, that
  297.                                 to  run  FastEcho  properly,  you  have  to
  298.                                 define  ONE  area  as  the  'Badmailboard',
  299.                                 otherwise it will  fail.  To  enable  dupe-
  300.                                 checking,  you  have  to  define ONE are as
  301.                                 'Dupeboard'.
  302.  
  303.                 Carbon-Copies
  304.  
  305.                                 This  is  one  of  the  unusual features of
  306.                                 FastEcho.  While  tossing   it   may   copy
  307.                                 certain  mails  not  only  in  the   normal
  308.                                 echo-area, but also in another board.  Here
  309.                                 you may setup the necessary information
  310.  
  311.  
  312.                 AreaFix-Options
  313.  
  314.                                 Several AreaFix options
  315.  
  316.  
  317. Running FASTECHO.EXE
  318. ====================
  319.  
  320.     FastEcho  does have several commands and commandline-switches. These are
  321.   listed here:
  322.  
  323.    TOSS - Toss Incoming Mail
  324.    -------------------------
  325.  
  326.       This executes  FastEcho's  TOSS  function.   This  will  search  your
  327.     inbound files directory for mail and toss it into your QBBS-messagebase
  328.     - netmail-messages will end up in the netmail-directory, while echomail
  329.     will be put into the correct messagearea. Mails will  be  forwarded  to
  330.     the systems linked to the echomail-areas (on node-systems).
  331.  
  332.       Should TOSS encounter an ARCmail file from which  it  cannot  extract
  333.     the mail-packets successfully, it will  rename  the  file  to  have  an
  334.     extension of .BAD so that you can look at it - the  file  will  not  be
  335.     processed again until you rename it back to .PKT.
  336.  
  337.       TOSS will leave with different errorlevels depending on  what  action
  338.     was actually performed:
  339.  
  340.          0      -      no mails imported
  341.         10      -      netmail imported
  342.         11      -      echomail imported
  343.         12      -      net- & echomail imported
  344.  
  345.       This  enables  you  to  set  up  your  batch-files  according  to the
  346.     errorlevel.
  347.  
  348.     Switches
  349.     --------
  350.  
  351.                 -B     Check Badmail first
  352.  
  353.                         This  will  force  TOSS to search the badmail-board
  354.                         just  before tossing incoming mails for newly added
  355.                         echomail-areas and will move these messages to  the
  356.                         recently created board.
  357.  
  358.                 -C     Make Carbon-Copies
  359.  
  360.                         This  enables  the  'Carbon-Copy'-feature.  Special
  361.                         mails are not only stored in the  normal  echomail-
  362.                         area  but  also in a area you specified in the your
  363.                         setup.  Please refer to the online-help of  FESetup
  364.                         for further details.
  365.  
  366.                 -F     Don't create File-attach
  367.  
  368.                         This disables FastEcho to create a new  file-attach
  369.                         when  it created a new packet. This may be used for
  370.                         example when you want to pack the messages for your
  371.                         sysop-point if you are a node.
  372.  
  373.  
  374.                 -S     temporarily turn off Security checks
  375.  
  376.                         Run  with  this  switch,  FastEcho  Toss  will  not
  377.                         perform  any  security  checks  on  incoming  mail-
  378.                         packets.
  379.  
  380.  
  381.    SCAN - Scan for Outgoing Mail
  382.    -----------------------------
  383.  
  384.       This  enables  the echomail SCAN function.  The QBBS-messagebase will
  385.     be  searched for outgoing echomail exporting it to packets. Further, it
  386.     will scan the messagebase for netmails stored in QBBS-netmailboards and
  387.     moves them to your *.MSG netmail-directory for further processing.
  388.  
  389.       If not found in the exported message, tearline and  origin-line  will
  390.     be added to it in the packet.  FastEcho will by default add/replace its
  391.     own ^APID-kludge in the exported mail to show the reader that this mail
  392.     was  scanned  by  FastEcho.  In the registered version it's possible to
  393.     turn this off and use the tearline instead.
  394.  
  395.     Switches
  396.     --------
  397.                 -N     Don't use ECHOMAIL.BBS
  398.  
  399.                         To speed up  the SCAN  FastEcho uses by default the
  400.                         ECHOMAIL.BBS file normally created by  your  editor
  401.                         when  you  write  a new message. This file contains
  402.                         the numbers of all new written messages. If  you  -
  403.                         for some purposes - don't  want FastEcho to use it,
  404.                         this feature may be disabled.
  405.  
  406.                 -A     Always use ECHOMAIL.BBS
  407.  
  408.                         This will force FastEcho to SCAN  your  messagebase
  409.                         only  if  you've  written  new  messages  and  your
  410.                         editor  created  this  file. Otherwise it will just
  411.                         exit without any action.
  412.  
  413.                 -F     Don't create File-attach
  414.  
  415.                         [see above]
  416.  
  417.  
  418.   PACK - Pack outgoing netmails
  419.   -----------------------------
  420.  
  421.      This  calls  the  netmail-packer.  This means  that  the  not-yet-sent
  422.    netmails are packed accordingly to your routing setup with FESetup or to
  423.    the runtime-parameters  you  may  specify.  Only  netmails  without  any
  424.    'priority-flags'  such  as  'Crash',  'Direct'  or  'Immediate'  will be
  425.    packed.
  426.  
  427.      If you only call FastEcho PACK without any special  routing-statements
  428.    it  will  use  the  default  routing  you  set  up  in the Node-Manager.
  429.    Otherwise it will perform the routing you specify in the command-line.
  430.  
  431.  
  432.    Routing Statements
  433.    ------------------
  434.  
  435.         PACK Address [Address] [Address]... [via Address]
  436.  
  437.           If you don't specify  a  'via'  address,  the  netmails  will  be
  438.         packed  for  each  address and one packet will be  created for each
  439.         address.   Otherwise   all   netmails  destined  to  the  specified
  440.         addresses  will  be  packed  and  routed  to the 'via' address. The
  441.         destination-addresses may be shortened if packing for (your) points
  442.         - for example 'PACK .3 .4 .5 .6' will pack the  netmails  for  your
  443.         points.
  444.  
  445.           You   may   specify  wildcards  '*'  &  '?'  in  the  destination
  446.         address-fields.  If you do so, a 'via' address is mandatory !!!
  447.  
  448.           This wildcarding is more flexible than the wildcarding  that  may
  449.         be used in the Node-Manager as it may be used within an address.
  450.  
  451.           Valid wildcarded addresses are for example:
  452.  
  453.                 2:24*           -    will pack all mails for region 24
  454.  
  455.                 9:492/6??       -    will pack all mails for all 6?? nodes
  456.                                      (for example 610, 623 etc.). This
  457.                                      enables you to perform a kind of HUB-
  458.                                      routing with FastEcho.
  459.  
  460.    Switches
  461.    --------
  462.  
  463.                 -F      -      Don't create File-attach
  464.  
  465.                                 [see above]
  466.  
  467.  
  468.   AFIX - process AreaFix requests
  469.   -------------------------------
  470.  
  471.      This function scans the netmail-directory for  messages  addressed  to
  472.    AreaFix,  AreaMgr,  AreaLink  or  EchoMgr  on  your  system.  With  such
  473.   messages your downlinks can link/unlink themselves to echomail areas  and
  474.   perform several other changes.
  475.  
  476.      For an complete listing of all  metacommands  accepted  by  FastEcho's
  477.    AreaFix have a look at the enclosed file 'AREAFIX.HLP' - it  also  gives
  478.    hints for your downlinks/points on how to write a mail  to  AreaFix,  it
  479.    should be defined as 'AreaFix-Helpfile' in your Setup.
  480.  
  481.      All commands are processed top-down, so  note  that  the  metacommands
  482.    '%DAYS'  and  '%MSGS' have  to  be  defined  BEFORE  the  area(s),  that
  483.    actually should be rescanned.
  484.  
  485.      Note: the processing of AreaFix request is run automatically after the
  486.    TOSS function has been completed !
  487.  
  488.  
  489.   NOTIFY - send link information to your downlinks
  490.   ------------------------------------------------
  491.  
  492.      This  command  lets  you  send link information normally requested via
  493.    'AreaFix %INFO' to all or to selected downlinks.
  494.  
  495.      Run without any parameter, it will send this info  to  all  downlinks.
  496.    Also,  you may specify the single systems which should receive this info
  497.    by giving their address on the commandline like:
  498.  
  499.                 FastEcho Notify 2:245/31 1:2607/302
  500.  
  501.      Further,  you  may  abbreviate  the   system's   addresses   -   valid
  502.    abbreviations are:
  503.  
  504.                         .1              send to your Point .1
  505.  
  506.                         31              send to node 31 in the network
  507.                                         of your primary matrix-address
  508.  
  509.  
  510.   STAT - generate echomail statistics
  511.   -----------------------------------
  512.  
  513.      This starts the statistical function of FastEcho. Every TOSS or SCAN a
  514.    database will be updated containing the  number  of  tossed  or  scanned
  515.    messages  on  each  board.   This  function  creates  a  human  readable
  516.    statistics  from this database. The statistics will be added to the file
  517.    specified in FESetup.
  518.  
  519.      By  default  FastEcho  STAT  will  leave  the database untouched after
  520.    generation, so any new TOSS or SCAN after STAT will add the new data.
  521.  
  522.      If run with the -R - switch, FastEcho  will reset the  database  after
  523.    execution, so the next STAT will only show the statistics after the last
  524.    STAT  -R.   This  enables  you for example to generate weekly or monthly
  525.    statistics  rather  than  a  overall  statistics  that will be generated
  526.    without resetting the database.
  527.  
  528.      The database is stored in FASTECHO.DAT.
  529.  
  530.  
  531. Running FESETUP.EXE
  532. ===================
  533.  
  534.   FESetup accepts several commandline-switches - run with '?' it displays:
  535.  
  536.            ╒════════════════════════════════════════════╡Usage╞═╕
  537.            │                                                    │
  538.            │ You may call FESETUP.EXE using following switches: │
  539.            │                                                    │
  540.            │ -C  : Color display [with Snow-Checking on CGA]    │
  541.            │ -A  : Use alternative colors                       │
  542.            │ -M  : Monochrome display                           │
  543.            │ -B  : access screen via Bios [very slow]           │
  544.            │                                                    │
  545.            │ -XA : eXport AREAS.BBS                             │
  546.            │ -XS : eXport FASTECHO.SYS [FastEcho configuration] │
  547.            │                                                    │
  548.            ╘════════════════════════════════════════════════════╛
  549.  
  550.  
  551. Running FEUTIL.EXE
  552. ==================
  553.  
  554.    FEUtil is QBBS-Messagebase-utility  that  helps  you  to  maintain  your
  555.  messagebase. It has built-in help-screens for all commands available  with
  556.  '?'.
  557.  
  558.  Following commands are available. The switches may be shortened !
  559.  
  560.   Index
  561.   -----
  562.  
  563.    FEUtil Index
  564.  
  565.      The Index command can be used to create the following  indexfiles  out
  566.    of MSGHDR.BBS:
  567.  
  568.           MSGIDX.BBS     This file contains the messagenumber and -board of
  569.                          each record in the messagebase
  570.  
  571.           MSGTOIDX.BBS   This file contains the names of the addressees  of
  572.                          each record in the messagebase
  573.  
  574.           MSGINFO.BBS    This file contains global information  about  your
  575.                          messagebase regarding the number of  messages  (on
  576.                          each board, totally, highest/lowest message etc.)
  577.  
  578.      Note that these indexfiles are also created  by  the  Pack,  Sort  and
  579.    Purge commands, so normally this command is not needed.
  580.  
  581.  
  582.   Purge
  583.   -----
  584.  
  585.    FEUtil Purge [-Delete]
  586.  
  587.      The  Purge  command  is  used  to  delete messages based on criterions
  588.    specified in the Area-Manager of FESetup. These criterions may be set on
  589.    per-area-basis or per default.
  590.  
  591.    Switches:
  592.  
  593.         -D or -Delete     Delete all messages in unknown boards
  594.  
  595.  
  596.   Pack
  597.   ----
  598.  
  599.    FEUtil Pack [-Force] [-Overwrite] [-Renumber] [-Delete]
  600.  
  601.      The  Pack command allows to compress the messagebase-files by removing
  602.    deleted messages and/or removing crosslinked messages.
  603.  
  604.      FEUtil Pack without -Overwrite or -Force will create new  messagebase-
  605.    files  and  delete  the old upon error-free execution. The -Force switch
  606.    causes the files to be overwritten, which has some  advantages  and dis-
  607.    advantages:
  608.                - no free disk-space needed
  609.                - less fragmentation
  610.                ! possible total loss of data if interupted while execution
  611.  
  612.      The -Overwrite switch will cause FEUtil to only overwrite the message-
  613.    basefiles  if  short  of  disk-space. Without these switches FEUtil will
  614.    quit without packing if not enough disk-space is available.
  615.  
  616.      FEUtil  will  automatically  renumber  if the highest messagenumber is
  617.    higher than what you defined for 'AutoRenumber' in FESetup  rather  than
  618.    always renumbering with -Renumber.
  619.  
  620.  
  621.    Switches:
  622.  
  623.         -F or -Force      Force overwriting of the existing messagebase-
  624.                           files
  625.         -O or -Overwrite  Overwrite existing files only if short of disk-
  626.                           space
  627.         -R or -Renumber   Renumber messages and update LASTREAD pointers
  628.                           (may be done by AutoRenumber)
  629.         -D or -Delete     Delete messages crosslinked in MSGTXT.BBS
  630.  
  631.  
  632.   Link
  633.   ----
  634.  
  635.    FEUtil Link
  636.  
  637.      The  Link  command  can  link  messages  with  the  same  subject to a
  638.    reply-chain that can be followed with your message-editor.
  639.  
  640.      FEUtil will always create new chains rather than linking new  messages
  641.    to existing chains like other programs do. It will remove  'Re:',  '(R)'
  642.    and familiar junks from the subjects.
  643.  
  644.  
  645.   Sort
  646.   ----
  647.  
  648.    FEUTIL Sort [-Backup]
  649.  
  650.      The Sort command allows to sort all unread messages by boardnumber and
  651.    date and time of posting.
  652.  
  653.      FEUtil will remove all reply chains while sorting, so you  should  run
  654.    'FEUtil Link' each time you used Sort.
  655.  
  656.    Switch:
  657.  
  658.         -B or -Backup    Keep the original MSGHDR.BBS as backup (.BAK)
  659.  
  660.  
  661.   Undelete
  662.   --------
  663.  
  664.    FEUtil Undelete [Board]
  665.  
  666.      The  Undelete  command  allows  you  to  undelete  messages  that  are
  667.    currently  deleted by FEUtil Purge or your message-editor.  The undelete
  668.    may either be performed on the whole messagebase or on a special area.
  669.  
  670.      If specified, Board may be the area-name ('FDECHO.GER' for example) or
  671.    the QBBS-board-number preceded by a '#' (e.g. '#121'). If not specified,
  672.    the whole messagebase will be searched for deleted messages.
  673.  
  674.      Beware that FEUtil can't undelete messages after the  messagebase  has
  675.    been PACKed right  before,  because  FEUtil  PACK  removes  all  deleted
  676.    messages !
  677.  
  678.   Import
  679.   ------
  680.  
  681.    FEUtil Import [-Incl file] [-Excl file]
  682.  
  683.      This function imports netmails addressed to your system from the *.MSG
  684.    netmail-directory into your QBBS netmailboards you defined in the  Area-
  685.    Manager.  You may define different netmailboards for your different akas
  686.    (be setting 'Use Aka' for each area) - the mail will get imported to the
  687.    correct board.
  688.  
  689.      Besides from the possibility to exclude the names of the  'Users'  and
  690.    'Sysops'  defined  in  FESetup,  you  can  'include' and 'exclude' mails
  691.    addressed to special users by using the '-Incl' and '-Excl' files. These
  692.    files may either be plain text files with one user name each line (case-
  693.    insensitive) or QBBS-compatible 'USERS.BBS' files used/created  by  your
  694.    BBS software.
  695.  
  696.      If  '-Incl'  is used, only mails to one of the users specified in this
  697.    file will be imported. Mails *not* to one of the users will  be  ignored
  698.    and left in your *.MSG netmail.
  699.  
  700.      If  '-Excl'  is  used,  mails to users listed in this file will not be
  701.    imported, even if they are listed in the '-Incl' list  as  the  exclude-
  702.    check is run AFTER the include-check.
  703.  
  704.  
  705.   Post
  706.   ----
  707.  
  708.    FEUtil Post <File> <Board> [-From Name] [-To Name] [-Subj Line]
  709.  
  710.      This  function  lets  you  send  the  contents  of an ASCII file as an
  711.    echomail  message.  It  creates  a  new  message  in  the  given  board,
  712.    optionally containing the values of From, To and Subj in the header  and
  713.    the contents of the file as message text.
  714.  
  715.      Defaults (if not given at commandline) for the header are:
  716.  
  717.                 From:   first user defined under 'User names' in FESetup
  718.                         OR "SysOp" if not defined
  719.  
  720.                 To:     "All"
  721.  
  722.                 Subj:   filename
  723.  
  724.      To  enter  values  containing more than one word you have to set these
  725.    words in double-quotes. Otherwise FEUtil won't accept them and return an
  726.    error. Example:
  727.  
  728.                 FEUtil Post c:\dummy #10 -To "All OS/2 freaks"
  729.  
  730.      Board may either be the area-name ('SHAREWRE' for example) or the QBBS
  731.    board-number preceded by a '#' (e.g. '#122').
  732.  
  733.  
  734.   Move
  735.   ----
  736.  
  737.    FEUtil Move <Board1> <Board2>
  738.  
  739.      The  move  functions  moves  all  messages from Board1 to Board2. Like
  740.    before, the board may either be the area-name or  the  QBBS-board-number
  741.    preceded by a '#'.
  742.  
  743.  
  744.   Check
  745.   -----
  746.  
  747.    FEUtil Check [-Delete]
  748.  
  749.      This  functions  checks  your complete QBBS messagebase for any errors
  750.    and  optionally  deletes  all  mails  that  are  found  to be bad and/or
  751.    rebuilds your index files (MSGIDX.BBS, MSGTOIDX.BBS and MSGINFO.BBS).
  752.  
  753.      If  '-Delete'  is NOT specified, it will simply tell you what is wrong
  754.   (or 'No error' if everything is allright) and then return  an  Errorlevel
  755.   of 111.
  756.  
  757.  
  758. Environment Variables
  759. =====================
  760.  
  761.   Following environment variables are used by FastEcho if specified:
  762.  
  763.         FD         If you  specify  FrontDoor(tm) as  Mailer and Auto-Area-
  764.                    Create adds a new area.
  765.  
  766.         FEOPT      This variable may be used for special runtime-parameters
  767.  
  768.                    Usage:
  769.  
  770.                         SET FEOPT=flag,flag,...
  771.  
  772.                    Following flags are available:
  773.  
  774.                         USEBIOS         use  BIOS-calls  when printing  to
  775.                                         screen rather  than direct screen-
  776.                                         writes.
  777.  
  778.                         USEANSI         use  ANSI  driver when printing to
  779.                                         screen rather  than direct screen-
  780.                                         writes (uses BIOS as well)
  781.  
  782.                         NO386           This  disables the  386-support in
  783.                                         FEUtil.
  784.  
  785.                         NOEMS           don't use EMS for memory expansion
  786.  
  787.                         NOAFIX          don't process  AreaFix-mails after
  788.                                         tossing
  789.  
  790.                         NOPACK          don't pack outbound mail  -  leave
  791.                                         it as .QQQ in  outbound directory.
  792.                                         (will  be  processed the next time
  793.                                         you run FastEcho)
  794.  
  795.                         NODUPES         temporarily  don't  perform  dupe-
  796.                                         checking
  797.  
  798.                         NETPID          replace PID in PACKed netmails
  799.  
  800.                         NOEXPORT        don't forward  mails  to downlinks
  801.                                         while tossing
  802.  
  803.                         NOPID           In  the  registered  version  this
  804.                                         skips the  adding/replacing of the
  805.                                         ^APID-Kludge    when     exporting
  806.                                         messages.
  807.  
  808.  
  809. Errorlevels
  810. ===========
  811.  
  812.                 Errorlevel              Meaning
  813.                 ------------------------------------------------------
  814.                         0               nothing to do/no errors
  815.                         1               packed/scanned net-/echomail
  816.                         3               key-failure
  817.                        10               imported netmail
  818.                        11               imported echomail
  819.                        12               imported echo- & netmail
  820.                       246               Can't lock messagebase
  821.                       247               Can't create .PKT-file
  822.                       250               wrong switch
  823.                       251               size mismatch
  824.                       254               not enough memory
  825.                       255               general error
  826.  
  827.  
  828. Batchfiles
  829. ==========
  830.  
  831.     Here is an example how to run FastEcho and FEUtil in batch-mode:
  832.  
  833.         :START
  834.         [...]
  835.  
  836.         rem --- Packmail ---
  837.  
  838.         :SCANNER
  839.         fastecho scan
  840.         goto start
  841.  
  842.         rem --- Unpackmail ---
  843.  
  844.         :UNPACKBAD
  845.         fastecho toss -b -c
  846.         goto AFTERTOSS
  847.  
  848.         :UNPACKMAIL
  849.         fastecho toss -C
  850.  
  851.         :AFTERTOSS
  852.         if errorlevel 12 goto ECHOMAIL
  853.         if errorlevel 11 goto ECHOMAIL
  854.         if errorlevel 10 goto ONLYNET
  855.         if errorlevel  0 goto ONLYNET
  856.  
  857.         :ECHOMAIL
  858.         feutil sort -b
  859.         feutil link
  860.  
  861.         :ONLYNET
  862.         newscan N -PL -F -R -X -SN
  863.         trackm
  864.         goto start
  865.  
  866.         rem --- PackNetmail ----
  867.  
  868.         :PACKNETMAIL
  869.         trackm
  870.  
  871.         rem     Pack mails for points
  872.         fastecho pack .1 .2 .3 .4 .5 .6 .7 .11
  873.  
  874.         rem     Default routing
  875.         fastecho pack
  876.  
  877.         goto START
  878.  
  879.         rem --- Messagebase-maintenance ---
  880.  
  881.         :MAINTAIN
  882.         feutil Purge
  883.         feutil Pack -Force -Delete
  884.  
  885.         goto START
  886.  
  887.  
  888. Help Systems, Registration Sites, Support
  889. =========================================
  890.  
  891.     If  you  want to register FastEcho or want to obtain nearer information
  892.   about FastEcho please refer to following Help Systems:
  893.  
  894.         Headquarters:
  895.                         Software Technik Burchhardt
  896.                         Mittelkamp 18
  897.                         D-4355 Waltrop
  898.                         Germany
  899.  
  900.                         Tel. ++49-2309-72746 (voice)
  901.                              ++49-2309-77019 (data, mail-only)
  902.  
  903.                         Email:  2:245/39@fidonet.org (Tobias Burchhardt)
  904.                                 9:492/6050@virnet.ftn
  905.                                 27:1331/701.20@signet.ftn
  906.  
  907.  
  908.         Help & Registration BeNeLux:
  909.  
  910.                         RCE Macaré
  911.                         Gaesbeekstraat 77b
  912.                         3081 NE  Rotterdam
  913.                         Holland
  914.  
  915.                         Email:  2:285/501@fidonet (Rob Macare)
  916.                                 27:1331/1@signet.ftn
  917.  
  918.  
  919.         Help & Registration U.S.A./Canada:
  920.  
  921.                         Direct Computer Resources
  922.                         10640 Torrey Road
  923.                         Willis, Michigan  48191
  924.                         U.S.A.
  925.  
  926.                         Email:  1:2380/300@fidonet (Dave Rasche)
  927.  
  928.  
  929.     For further information regarding registration,  please  refer  to  the
  930.   enclosed LICENSE.DOC and the registration forms in REGISTER.LZH.
  931.  
  932.  
  933. Thanks
  934. ======
  935.  
  936.     I would like to thank all people that contributed to the development of
  937.   FastEcho:
  938.  
  939.         Peter Bankmann          2:245/31                My HUB/Support
  940.         Rob Macare              2:285/501               BeNeLux-Support
  941.         Dave Rasche             1:2380/300              USA/Canada-Support
  942.  
  943.         dirk astrath            2:241/5603              first beta-tester
  944.  
  945.         joaquim homrighausen, gerard van.der.land and  Fabiano  Fabris  for
  946.         their excellent products which gave me the kick to write FastEcho.
  947.  
  948.  
  949.     Thanks  to  all  the  people  who  registered FastEcho 1.0X and made it
  950.   possible for me to keep on developing.
  951.  
  952.  
  953.     The beta-crew:
  954.  
  955.         dirk astrath, Klaus Ditze, Michael Schmitz, Thomas Schätzer, Markus
  956.         Schmidt,  Markus  Ebel,  Bernd  Hinkmann,  Herbert   Werner,   Erik
  957.         Wachtmeester,  Sikko  Stienstra,  Steven  van Dijk, Tjibbe Hofkamp,
  958.         Erick van Emmerik, Manfred Pegam, Rainer Cremer, Thorsten  Frische,
  959.         Kaj Sevelin, Johnny Engström, Dan Åkerlund,  Åke  Gustafsson,  Hugo
  960.         Landsman,  Jan  Willem  den  Besten, Wim Touw, Wolfgang Gröber, Jan
  961.         Sevelin, Walter Schick, Dave Rasche, Ken  Maskall,  Joerg  Michael,
  962.         Michael  Kramm,  Jupp  Demary, Carsten Henkel, Andreas Walter, Axel
  963.         Cordt, Gody Keyzer,  Rob  Macare,  Jens  Freitag,  Frank  Lachmann,
  964.         Daniel Zeilmann and last but not least Georg Burchhardt ...
  965.  
  966.         Sorry if I forgot one ! :-)
  967.  
  968.  
  969. Technical Notes
  970. ===============
  971.  
  972.   * The FTSC product-code for FastEcho is 0xAF (hex), 175 (dec).
  973.  
  974.   * FastEcho can handle up to 200 systems and 960 areas.
  975.  
  976.   * The  mail-packets  created  by  FastEcho  are  compatible  to FTS-0001,
  977.     FTS-0004  and  FSC-0039, using the Type 2+ packet-header and supporting
  978.     the Capability Word.  FastEcho will also  recognize  incoming  FSC-0048
  979.     mail-packets.
  980.  
  981.   * Linefeeds are always stripped when  processing  mails,  soft  CR's  are
  982.     treated as normal, valid characters.
  983.  
  984.   * SEEN-BY lines and ^APATH kludges are created and updated.
  985.  
  986.   * SEEN-BY  is  used  for  duplicate  prevention - if a system is  already
  987.     listed in the SEEN-BY of an incoming message, FastEcho will not forward
  988.     that  message to this system.  [This does NOT apply to point-systems as
  989.     the SEEN-BY are 2D only !]
  990.  
  991.   * FastEcho can parse both Fido/Opus-  and  SEAdog-style  date-fields,  it
  992.     generates Fido/Opus-style date-fields when exporting mail.
  993.  
  994.   * FastEcho  supports the RemoteAccess/FrontDoor QBBS-messagebase  sharing
  995.     specifications.
  996.  
  997.   * Outbound mail-packets generated by FastEcho have a .QQQ  extension.  To
  998.     compress them, FastEcho renames them to .PKT and adds 2 <NUL> bytes  at
  999.     the end of the packets. If any error occurs while running the archiver,
  1000.     FastEcho will rename them back to .QQQ, so the may be compressed  in  a
  1001.     further run of FastEcho.
  1002.  
  1003.   * For  a  better performance, unlike other  echomail processors, FastEcho
  1004.     keeps the outbound mail-packets open while processing. Therefore to run
  1005.     without  error you must give FastEcho at least that many FILES=??? that
  1006.     are  needed  to  have  the  packets  for  every  system  defined in the
  1007.     Node-Manager simultaneously open.
  1008.  
  1009.   * FastEcho supports the 4D addressing which BinkleyTerm 2.50+ offers  for
  1010.     points.
  1011.  
  1012.   * FastEcho supports the '.BSY' files  created  by  BinkleyTerm  2.50+  in
  1013.     multiline-environments   and  will  not  compress  mail  for  a  system
  1014.     currently online.
  1015.  
  1016.   * FastEcho supports the  semaphore  files  FrontDoor  2.10/c  creates  in
  1017.     multiline-environments  and  will  not  compress  mail  for  a   system
  1018.     currently online.
  1019.  
  1020.   * FastEcho  was  written  in  C++ (Borland C++ Version 3.0) and  assembly
  1021.     language (Turbo Assembler Version 3.0).
  1022.  
  1023.   * File-IO is performed using standard DOS filehandle functions.  The  PSP
  1024.     filehandle table is expanded to 230 entries.
  1025.  
  1026.   * The  programs  automatically  detects DESQview and write to its  screen
  1027.     buffer.
  1028.  
  1029.   * The configuration file of  FastEcho may be used with  GoldED 2.40.P0623
  1030.     or later.
  1031.  
  1032.   * The swapping routines used are provided by Ralph Brown (SPAWNO 4.1) and
  1033.     allow EMS-, XMS and disk-swapping.
  1034.  
  1035.   * FESetup makes intensive use of the TesSeRact CLX  User  Interface  TCXL
  1036.     Version 5.52.06 copyrighted by Innovative Data Concepts.
  1037.  
  1038. [EOF]
  1039.